<!DOCTYPE html>
<html>
<head>
<title>MANUAL</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<style type="text/css">
/* GitHub stylesheet for MarkdownPad (http://markdownpad.com) */
/* Author: Nicolas Hery - http://nicolashery.com */
/* Version: b13fe65ca28d2e568c6ed5d7f06581183df8f2ff */
/* Source: https://github.com/nicolahery/markdownpad-github */

/* RESET
=============================================================================*/

html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary, time, mark, audio, video {
  margin: 0;
  padding: 0;
  border: 0;
}

/* BODY
=============================================================================*/

body {
  font-family: Helvetica, arial, freesans, clean, sans-serif;
  font-size: 14px;
  line-height: 1.6;
  color: #333;
  background-color: #fff;
  padding: 20px;
  max-width: 960px;
  margin: 0 auto;
}

body>*:first-child {
  margin-top: 0 !important;
}

body>*:last-child {
  margin-bottom: 0 !important;
}

/* BLOCKS
=============================================================================*/

p, blockquote, ul, ol, dl, table, pre {
  margin: 15px 0;
}

/* HEADERS
=============================================================================*/

h1, h2, h3, h4, h5, h6 {
  margin: 20px 0 10px;
  padding: 0;
  font-weight: bold;
  -webkit-font-smoothing: antialiased;
}

h1 tt, h1 code, h2 tt, h2 code, h3 tt, h3 code, h4 tt, h4 code, h5 tt, h5 code, h6 tt, h6 code {
  font-size: inherit;
}

h1 {
  font-size: 28px;
  color: #000;
}

h2 {
  font-size: 24px;
  border-bottom: 1px solid #ccc;
  color: #000;
}

h3 {
  font-size: 18px;
}

h4 {
  font-size: 16px;
}

h5 {
  font-size: 14px;
}

h6 {
  color: #777;
  font-size: 14px;
}

body>h2:first-child, body>h1:first-child, body>h1:first-child+h2, body>h3:first-child, body>h4:first-child, body>h5:first-child, body>h6:first-child {
  margin-top: 0;
  padding-top: 0;
}

a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 {
  margin-top: 0;
  padding-top: 0;
}

h1+p, h2+p, h3+p, h4+p, h5+p, h6+p {
  margin-top: 10px;
}

/* LINKS
=============================================================================*/

a {
  color: #4183C4;
  text-decoration: none;
}

a:hover {
  text-decoration: underline;
}

/* LISTS
=============================================================================*/

ul, ol {
  padding-left: 30px;
}

ul li > :first-child, 
ol li > :first-child, 
ul li ul:first-of-type, 
ol li ol:first-of-type, 
ul li ol:first-of-type, 
ol li ul:first-of-type {
  margin-top: 0px;
}

ul ul, ul ol, ol ol, ol ul {
  margin-bottom: 0;
}

dl {
  padding: 0;
}

dl dt {
  font-size: 14px;
  font-weight: bold;
  font-style: italic;
  padding: 0;
  margin: 15px 0 5px;
}

dl dt:first-child {
  padding: 0;
}

dl dt>:first-child {
  margin-top: 0px;
}

dl dt>:last-child {
  margin-bottom: 0px;
}

dl dd {
  margin: 0 0 15px;
  padding: 0 15px;
}

dl dd>:first-child {
  margin-top: 0px;
}

dl dd>:last-child {
  margin-bottom: 0px;
}

/* CODE
=============================================================================*/

pre, code, tt {
  font-size: 12px;
  font-family: Consolas, "Liberation Mono", Courier, monospace;
}

code, tt {
  margin: 0 0px;
  padding: 0px 0px;
  white-space: nowrap;
  border: 1px solid #eaeaea;
  background-color: #f8f8f8;
  border-radius: 3px;
}

pre>code {
  margin: 0;
  padding: 0;
  white-space: pre;
  border: none;
  background: transparent;
}

pre {
  background-color: #f8f8f8;
  border: 1px solid #ccc;
  font-size: 13px;
  line-height: 19px;
  overflow: auto;
  padding: 6px 10px;
  border-radius: 3px;
}

pre code, pre tt {
  background-color: transparent;
  border: none;
}

kbd {
    -moz-border-bottom-colors: none;
    -moz-border-left-colors: none;
    -moz-border-right-colors: none;
    -moz-border-top-colors: none;
    background-color: #DDDDDD;
    background-image: linear-gradient(#F1F1F1, #DDDDDD);
    background-repeat: repeat-x;
    border-color: #DDDDDD #CCCCCC #CCCCCC #DDDDDD;
    border-image: none;
    border-radius: 2px 2px 2px 2px;
    border-style: solid;
    border-width: 1px;
    font-family: "Helvetica Neue",Helvetica,Arial,sans-serif;
    line-height: 10px;
    padding: 1px 4px;
}

/* QUOTES
=============================================================================*/

blockquote {
  border-left: 4px solid #DDD;
  padding: 0 15px;
  color: #777;
}

blockquote>:first-child {
  margin-top: 0px;
}

blockquote>:last-child {
  margin-bottom: 0px;
}

/* HORIZONTAL RULES
=============================================================================*/

hr {
  clear: both;
  margin: 15px 0;
  height: 0px;
  overflow: hidden;
  border: none;
  background: transparent;
  border-bottom: 4px solid #ddd;
  padding: 0;
}

/* TABLES
=============================================================================*/

table th {
  font-weight: bold;
}

table th, table td {
  border: 1px solid #ccc;
  padding: 6px 13px;
}

table tr {
  border-top: 1px solid #ccc;
  background-color: #fff;
}

table tr:nth-child(2n) {
  background-color: #f8f8f8;
}

/* IMAGES
=============================================================================*/

img {
  max-width: 100%
}
</style>
<script type="text/javascript">
document.addEventListener("DOMContentLoaded", function() {
    // 生成目录列表
    var toc = document.createElement("ul");
    toc.setAttribute("id", "table-of-content");
    toc.style.cssText = "border: 1px solid #ccc;";
    document.body.insertBefore(toc, document.body.childNodes[0]);
    // 用于计算当前标题层级的栈,先进先出,从左到右每一个元素代表当前标题所在的层级索引，初始为空
    var stack = new Array();
    // 获取所有标题(h2-h6),h1作为主标题,h2为一级标题
    var headers = document.querySelectorAll('h2,h3,h4,h5,h6');
    for (var i = 0; i < headers.length; i++) {
        var header = headers[i];
        // 计算标题级数，为后面计算标号及缩进空格准备
        var level = parseInt(header.tagName.replace('H', ''), 10)-1;
        // 通过两个where循环对栈进行调整,确保stack中标题级数与当前标题级数相同
        while(stack.length < level){
        	stack.push(0);
        }
        while(stack.length > level){
        	stack.pop();
        }
        // 最小一级标题标号步进+1
        stack[stack.length-1]++;
        // 生成标题标号( 1.1,1.2.. )
        var index = stack.join(".")
        // 生成标题ID
        var id = "title" + index;
        header.setAttribute("id", id);
        // 为标题加上标号,如果不希望显示标号，把下面这行注释就可以了
        header.textContent = index + " " + header.textContent;
        toc.appendChild(document.createElement("li"));
        var a = document.createElement("a");
        // 为目录项设置链接
        a.setAttribute("href", "#" + id)
        // 目录项文本前面放置缩进空格
        a.innerHTML = new Array(level * 4).join('&nbsp;') + header.textContent;
        toc.lastChild.appendChild(a);
    }
});
</script>
</head>
<body>
<h1>dtalk(Device Talk)开发手册(更新中)</h1>
<h2>术语</h2>
<table>
<thead>
<tr>
	<th align="left">术语</th>
	<th align="left">描述</th>
</tr>
</thead>
<tbody>
<tr>
	<td align="left">(菜单)条目,item</td>
	<td align="left">dtalk设备端菜单数据组织的基本单元</td>
</tr>
<tr>
	<td align="left">(参数)选项,option</td>
	<td align="left">存储指定数据类型的数据条目对象,没有子条目</td>
</tr>
<tr>
	<td align="left">(设备)命令,cmd</td>
	<td align="left">设备端执行的指定动作的条目，可以包含一个或多个由option对象描述的参数，可以有返回值</td>
</tr>
<tr>
	<td align="left">菜单,menu</td>
	<td align="left">包含一个或多个opton或cmd的菜单条目</td>
</tr>
<tr>
	<td align="left">菜单命令</td>
	<td align="left">由管理端发送的一个item</td>
</tr>
</tbody>
</table>
<p>以下为上面术语中在对应的java类，及层次关系图：</p>
<p><img src="images/item.png" /></p>
<h2>设备命令</h2>
<p>我们希望通过管理软件向前端设备发指令做一些事性，比如开门，比如升级设备端的软件版本，比如汇报当前设备状态，这些事情都可以定义为设备命令。管理端通过dtalk,发送设备命令给前端，前端收到命令并执行然后返回执行结果。这就是基本的设备命令发送执行流程。</p>
<p>dtalk就是用来定义整个设备命令发送和执行的一个开发框架，是管理端和设备端和对话协议框架，所以叫它device talk,</p>
<p>dtalk是基于redis的频道发布订阅功能来实现管理端和设备端的交互通信。管理端和设备端之间建立通信，就是在redis上注册侦听两个消息频道，一个用于管理端向设备端发送命令请求(request channel)，另一个是反向的，叫命令响应频道(ack channel)，用于设备端向管理端发送命令请求的响应消息，由管理端侦听。</p>
<p>管理端让设备端执行一个命令，不论执行的成功或失败，设备端总要吱一声让管理端知道呀--这就是命令响应频道的作用。</p>
<p>管理端如何知道设备有哪些命令或管理选项呢？</p>
<p>这就是dtalk的核心协议：基于树形结构的管理选项定义---直观说就是一个层次结构的菜单</p>
<p><img src="images/menu01.png" /></p>
<blockquote>
<p>在管理端输入数字2，设备端将<code>faceloge 服务器</code>这个菜单项中的数据发送给管理端，在管理端呈现该菜单的详细内容</p>
</blockquote>
<p>如上所示的，设备端通过一个树形结构菜单定义自己能执行的设备命令和管理选项（在发送过程中以json字符串形式传递）。</p>
<p>上图中设备端发送给管理端的<code>faceloge 服务器</code>菜单的JSON数据</p>
<pre><code>{
    &quot;catalog&quot;: &quot;MENU&quot;,
    &quot;container&quot;: true,
    &quot;description&quot;: &quot;&quot;,
    &quot;disable&quot;: false,
    &quot;empty&quot;: false,
    &quot;name&quot;: &quot;facelog&quot;,
    &quot;path&quot;: &quot;/facelog&quot;,
    &quot;uiName&quot;: &quot;facelog \xe6\x9c\x8d\xe5\x8a\xa1\xe5\x99\xa8&quot;
    &quot;childs&quot;: 
    [
        {&quot;catalog&quot;: &quot;CMD&quot;,&quot;childs&quot;: [],&quot;container&quot;: true,&quot;description&quot;: &quot;&quot;,&quot;disable&quot;: false,&quot;empty&quot;: true,&quot;name&quot;: &quot;back&quot;,&quot;path&quot;: &quot;/&quot;,&quot;taskQueue&quot;: null,     &quot;uiName&quot;: &quot;back&quot;}, 
        {&quot;catalog&quot;: &quot;OPTION&quot;,&quot;childs&quot;: [],&quot;container&quot;: false,&quot;defaultValue&quot;: null,&quot;description&quot;: &quot;&quot;,    &quot;disable&quot;: false,&quot;empty&quot;: true,&quot;name&quot;: &quot;host&quot;,&quot;path&quot;: &quot;/facelog/host&quot;,&quot;readOnly&quot;: false,&quot;required&quot;: false,&quot;type&quot;: &quot;STRING&quot;,&quot;uiName&quot;: &quot;\xe4\xb8\xbb\xe6\x9c\xba\xe5\x90\x8d\xe7\xa7\xb0&quot;,&quot;value&quot;: &quot;localhost&quot;},
        {&quot;catalog&quot;: &quot;OPTION&quot;,&quot;childs&quot;: [],&quot;container&quot;: false,&quot;defaultValue&quot;: 0,&quot;description&quot;: &quot;&quot;,&quot;disable&quot;: false,&quot;empty&quot;: true,&quot;name&quot;: &quot;port&quot;,&quot;path&quot;: &quot;/facelog/port&quot;,&quot;readOnly&quot;: false,&quot;required&quot;: false,&quot;type&quot;: &quot;INTEGER&quot;,&quot;uiName&quot;: &quot;\xe7\xab\xaf\xe5\x8f\xa3\xe5\x8f\xb7&quot;,&quot;value&quot;: 26411}
    ],

}
</code></pre>

<p>管理端收到这个菜单数据后，可以以自己想要的形式呈现给用户。在dtalk实现的简单字符终端中，以简单的列表形式显示设备端管理菜单 。如果在浏览器上用js实现，可以实现更好看的呈现方式。</p>
<p>管理端有了这个菜单，就可以知道该设备有哪些参数可以设置修改，有哪些命令可以执行，每个命令的含义是啥，都需要什么样的参数。</p>
<p>我们把运行在设备端，响应管理的dtalk请求的模块称为dtalk引擎或设备命令引擎。</p>
<p>我们把运行在管理端，向用户呈现管理菜单，向设备端发送dtlk请求，并将收到的响应显示给用户的模块称为dtalk console，或命令console。</p>
<p>设备端有哪些命令和选项，可以根据项目的需要定义，定制设备命令菜单。dtalk engine(命令引擎)负责向管理端发送这个菜单，并执行管理端的设备命令请求。</p>
<p>也就是说，设备端的命令和参数选项完全是自由灵活的，动态定义的。</p>
<h2>建立连接</h2>
<p>如下图,设备端运行后，会订阅只属于自己的连接请求频道，这个频道的频道名是常量,名字格式-- <code>${设备端MAC地址}_dtalk_connect</code>,管理端要连接某台设备，必须要知道这台设备的MAC地址，有了MAC地址，就可以向这台设备发送连接请求，设备端收到连接请求后，会验证连接请求是否有效，如果有效则允许管理连接，就会向命令响应频道发送命令请求频道名(request channel)，这个频道名是动态生成的，名字格式--<code>${设备端MAC地址}_dtalk_[\d]+}</code>(后缀是个随机数)。</p>
<p>管理端启动后，会订阅只属于自己的命令响应频道名，这个频道的频道名是常量,名字格式---<code>${管理端MAC地址}_dtalk_ack</code>。管理端通过响应频道收到连接成功的信号后，也同时会收到命令请求频道名(request channel),有了这个request channel，管理端才能向设备端发送设备命令请求。</p>
<p>管理端到设备端的连接是独占的，设备端以管理端连接时提供的管理端MAC地址来区分管理端，不允许有两个不同的管理端同时连接到同一台设备。如果已经有一个管理端电脑A连接到了设备端，那么另一台管理端电脑B尝试连接该设备时就会报错:<code>ANOTHER CLIENT LOCKED</code></p>
<p><img src="images/connect.png" /></p>
<h3>验证连接</h3>
<p>设备如何验证管理端的连接请求是否合法呢？</p>
<p>dtalk默认的实现方式是密码验证</p>
<p>管理端连接设备端时，向连接请求频道发送如下连接请求数据：</p>
<pre><code>{
    &quot;mac&quot;: &quot;58fb842d294f&quot;,/** 管理端自己的MAC地址 */
    &quot;pwd&quot;: &quot;33902b064aab3e1c0db64827d8496fce&quot; /** 管理端提供的连接密码(已加密) */
}
</code></pre>

<blockquote>
<p><a href="..//dtalk-base/src/main/java/gu/dtalk/ConnectReq.java">gu.dtalk.ConnectReq</a>是上述连接请求字符串反序列化后的实现类</p>
</blockquote>
<p>设备端根据管理端提供的连接密码，与本机保存的密码相比较，如果匹配则允许连接，否则报错<code>INVALID REQUEST PASSWORD</code>。</p>
<h3>设备端实现</h3>
<p>关于建立连接的设备端实现参见<a href="../dtalk-engine/src/main/java/gu/dtalk/engine/SampleConnector.java">gu.dtalk.engine.SampleConnector</a></p>
<p>这只是dtalk提供的默认连接实现，应用程序在使用dtalk的时候，可以根据业务需求实现<a href="..//dtalk-engine/src/main/java/gu/dtalk/engine/RequestValidator.java">gu.dtalk.engine.RequestValidator</a> 接口，实现不同的连接验证方式。</p>
<p>比如<a href="https://gitee.com/l0km/facelog">facelog</a>项目在使用dtalk时就重写了此方法，参见<a href="https://gitee.com/l0km/facelog/blob/master/facelog-client-base/src/main/java/net/gdface/facelog/client/dtalk/TokenRequestValidator.java">net.gdface.facelog.client.dtalk.TokenRequestValidator</a></p>
<h3>管理端实现</h3>
<p>关于建立连接的管理端实现参见 <a href="../dtalk-client/src/main/java/gu/dtalk/client/SampleConsole.java">gu.dtalk.client.SampleConsole#authorize()</a>方法</p>
<h2>命令交互</h2>
<p>管理端与设备端命令交互的过程，就是管理发送菜单请求，设备端响应菜单请求的过程。</p>
<p>下面的json字符是一个完整的menu菜单示例</p>
<pre><code>    {&quot;catalog&quot;:&quot;MENU&quot;,&quot;name&quot;:&quot;&quot;,&quot;path&quot;:&quot;/&quot;,&quot;uiName&quot;:&quot;&quot;,&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:false,
        &quot;childs&quot;:[
            {&quot;catalog&quot;:&quot;CMD&quot;,&quot;name&quot;:&quot;quit&quot;,&quot;path&quot;:&quot;/quit&quot;,&quot;childs&quot;:[],&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:true,&quot;taskQueue&quot;:null,&quot;uiName&quot;:&quot;quit&quot;},
            {&quot;catalog&quot;:&quot;MENU&quot;,&quot;name&quot;:&quot;menu1&quot;,&quot;path&quot;:&quot;/menu1&quot;,&quot;uiName&quot;:&quot;菜单1&quot;,&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:false,
                &quot;childs&quot;:[
                {&quot;catalog&quot;:&quot;CMD&quot;,&quot;childs&quot;:[],&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:true,&quot;name&quot;:&quot;back&quot;,&quot;path&quot;:&quot;/&quot;,&quot;taskQueue&quot;:null,&quot;uiName&quot;:&quot;back&quot;},
                {&quot;catalog&quot;:&quot;MENU&quot;,&quot;name&quot;:&quot;menu1_1&quot;,&quot;path&quot;:&quot;/menu1/menu1_1&quot;,&quot;uiName&quot;:&quot;菜单1.1&quot;,,&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:false
                    &quot;childs&quot;:[
                        {&quot;catalog&quot;:&quot;CMD&quot;,&quot;name&quot;:&quot;back&quot;,&quot;path&quot;:&quot;/&quot;,&quot;taskQueue&quot;:null,&quot;uiName&quot;:&quot;back&quot;,&quot;childs&quot;:[],&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:true},
                        {&quot;catalog&quot;:&quot;OPTION&quot;&quot;name&quot;:&quot;option1&quot;,&quot;uiName&quot;:&quot;选项1&quot;,&quot;path&quot;:&quot;/menu1/menu1_1/option1&quot;,&quot;childs&quot;:[],&quot;container&quot;:false,&quot;defaultValue&quot;:null,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:true,,&quot;readOnly&quot;:false,&quot;required&quot;:false,&quot;type&quot;:&quot;STRING&quot;,&quot;value&quot;:null},
                        {&quot;catalog&quot;:&quot;OPTION&quot;,&quot;name&quot;:&quot;option2&quot;,&quot;uiName&quot;:&quot;选项2&quot;,&quot;path&quot;:&quot;/menu1/menu1_1/option2&quot;,&quot;childs&quot;:[],&quot;container&quot;:false,&quot;defaultValue&quot;:0,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:true,&quot;readOnly&quot;:false,&quot;required&quot;:false,&quot;type&quot;:&quot;INTEGER&quot;,&quot;value&quot;:null}
                    ]}]},
            {&quot;catalog&quot;:&quot;MENU&quot;,&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:false,&quot;name&quot;:&quot;menu2&quot;,&quot;path&quot;:&quot;/menu2&quot;,&quot;uiName&quot;:&quot;菜单2&quot;,
                &quot;childs&quot;:[
                    {&quot;catalog&quot;:&quot;CMD&quot;,&quot;name&quot;:&quot;back&quot;,&quot;path&quot;:&quot;/&quot;,&quot;uiName&quot;:&quot;back&quot;,&quot;childs&quot;:[],&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:true,&quot;taskQueue&quot;:null},
                    {&quot;catalog&quot;:&quot;MENU&quot;,&quot;name&quot;:&quot;menu2_1&quot;,&quot;path&quot;:&quot;/menu2/menu2_1&quot;,&quot;uiName&quot;:&quot;菜单2.1&quot;,&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:false,
                        &quot;childs&quot;:[
                            {&quot;catalog&quot;:&quot;CMD&quot;,&quot;name&quot;:&quot;back&quot;,&quot;uiName&quot;:&quot;back&quot;,&quot;path&quot;:&quot;/&quot;,&quot;childs&quot;:[],&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:true,&quot;taskQueue&quot;:null},
                            {&quot;catalog&quot;:&quot;CMD&quot;,&quot;name&quot;:&quot;cmd1&quot;,&quot;uiName&quot;:&quot;命令1&quot;,&quot;path&quot;:&quot;/menu2/menu2_1/cmd1&quot;,&quot;container&quot;:true,&quot;description&quot;:&quot;&quot;,&quot;disable&quot;:false,&quot;empty&quot;:true,&quot;taskQueue&quot;:null,
                                &quot;childs&quot;:[
                                    {&quot;catalog&quot;: &quot;OPTION&quot;,&quot;name&quot;: &quot;param1&quot;,&quot;uiName&quot;: &quot;命令参数1&quot;,&quot;path&quot;: &quot;/menu2/menu2_1/cmd1/param1&quot;,&quot;childs&quot;: [],&quot;container&quot;: false,&quot;defaultValue&quot;: null,&quot;description&quot;: &quot;&quot;,&quot;disable&quot;: false,&quot;empty&quot;: true,&quot;readOnly&quot;: false,&quot;required&quot;: false,&quot;type&quot;: &quot;STRING&quot;,&quot;value&quot;: null}
                                ]
                            }
                        ]}]}
        ]
    }
</code></pre>

<p>如下图，管理端通过命令请求频道发送菜单命令，设备端收到菜单命令后，根据菜单命令的类型执行相应的动作</p>
<p><img src="images/frame01.png" /></p>
<h3>MENU</h3>
<p>如果菜单命令是一个菜单(menu)，则设备端将对应的菜单内容(通过命令响应频道)返回给管理端，如下就是一条管理端发送给设备端的菜单(menu)命令.</p>
<pre><code>{&quot;catalog&quot;:&quot;MENU&quot;,&quot;path&quot;:&quot;/&quot;}
</code></pre>

<p>该命令只有两个字段:</p>
<ol>
<li><code>path</code>代表要执行的命令(在设备端菜单树形结构中)的全路径。&quot;/&quot;即为根菜单。</li>
<li><code>catalog</code>指定了该命令的类型为菜单(menu)，这个字段可以省略，设备端根据<code>path</code>就可以找到对应的menu,并将menu数据作为响应数据(ack)通过命令响应频道发送给管理端</li>
</ol>
<h3>OPTION</h3>
<p>如果菜单命令是一个选项(option)，则设备端会修改指定option的值，如下就是一条管理端发送给设备端的option菜单命令.</p>
<pre><code>{&quot;catalog&quot;:&quot;OPTION&quot;,&quot;path&quot;:&quot;/menu1/menu1_1/option1&quot;,&quot;value&quot;:&quot;HELLO&quot;}
#NOTE: 'catalog'字段可以省略
</code></pre>

<p>设备端收到这条命令后，就会将搜索<code>path</code>指定的选项,将该选项的值设置为<code>HELLO</code></p>
<h3>CMD</h3>
<p>如果菜单命令是一个(设备)命令(cmd)，则设备端会执行指定的设备命令，如下就是一条管理端发送给设备端的cmd菜单命令.</p>
<pre><code>{&quot;catalog&quot;:&quot;CMD&quot;,&quot;path&quot;:&quot;/menu2/menu2_1/cmd1&quot; &quot;childs&quot;:[{&quot;name&quot;: &quot;param1&quot;,&quot;value&quot;:&quot;HELLO&quot;}]}
#NOTE: 'catalog'字段可以省略
</code></pre>

<p>设备端收到这条命令后，会执行指定的动作，设备命令的内容由应用程序实现，比如设备重启，比如远程升级</p>
<p>上面这个例子中，<code>cmd1</code>这个设备命令定义了一个参数<code>param1</code>作为子节点</p>
<p>关于命令交互的设备端实现参见 <a href="../dtalk-engine/src/main/java/gu/dtalk/engine/BaseItemEngine.java">gu.dtalk.engine.BaseItemEngine</a></p>
<p>关于命令交互的管理端实现参见 <a href="../dtalk-client/src/main/java/gu/dtalk/client/BaseConsole.java">gu.dtalk.client.BaseConsole#cmdInteractive()</a>方法</p>
<h2>(菜单)条目定义</h2>
<h3>(菜单)条目类型说明</h3>
<table>
<thead>
<tr>
	<th align="left">TYPE</th>
	<th align="left">说明</th>
	<th align="left">Java类/基类</th>
</tr>
</thead>
<tbody>
<tr>
	<td align="left">OPTION</td>
	<td align="left">参数选项，对应《术语》中的(参数)选项</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/BaseOption.java">gu.dtalk.BaseOption</a></td>
</tr>
<tr>
	<td align="left">CMD</td>
	<td align="left">(设备)命令,cmd</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/CmdItem.java">gu.dtalk.CmdItem</a></td>
</tr>
<tr>
	<td align="left">MENU</td>
	<td align="left">菜单,menu</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/MenuItem.java">gu.dtalk.MenuItem</a></td>
</tr>
</tbody>
</table>
<h3>选项(OPTION)类型说明</h3>
<table>
<thead>
<tr>
	<th align="left">TYPE</th>
	<th align="left">JSON type for <code>value/defaultValue</code> field</th>
	<th align="left">说明</th>
	<th align="left">Java类</th>
</tr>
</thead>
<tbody>
<tr>
	<td align="left">STRING</td>
	<td align="left">string</td>
	<td align="left">任意字符串</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/StringOption.java">gu.dtalk.StringOption</a></td>
</tr>
<tr>
	<td align="left">INTEGER</td>
	<td align="left">number</td>
	<td align="left">整数</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/IntOption.java">gu.dtalk.IntOption</a></td>
</tr>
<tr>
	<td align="left">FLOAT</td>
	<td align="left">number</td>
	<td align="left">浮点数</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/FloatOption.java">gu.dtalk.FloatOption</a></td>
</tr>
<tr>
	<td align="left">BOOL</td>
	<td align="left">bool</td>
	<td align="left">布尔型 true/false 0/1</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/BoolOption.java">gu.dtalk.BoolOption</a></td>
</tr>
<tr>
	<td align="left">DATE</td>
	<td align="left">string</td>
	<td align="left">日期 支持的格式:yyyy-MM-dd HH:mm:ss</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/DateOption.java">gu.dtalk.DateOption</a></td>
</tr>
<tr>
	<td align="left">URL</td>
	<td align="left">string</td>
	<td align="left">url字符串</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/UrlOption.java">gu.dtalk.UrlOption</a></td>
</tr>
<tr>
	<td align="left">PASSWORD</td>
	<td align="left">string</td>
	<td align="left">密码字符串</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/PasswordOption.java">gu.dtalk.PasswordOption</a></td>
</tr>
<tr>
	<td align="left">EMAIL</td>
	<td align="left">string</td>
	<td align="left">e-mail地址</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/StringOption.java">gu.dtalk.StringOption</a></td>
</tr>
<tr>
	<td align="left">MPHONE</td>
	<td align="left">string</td>
	<td align="left">手机号码(11位)</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/StringOption.java">gu.dtalk.StringOption</a></td>
</tr>
<tr>
	<td align="left">IDNUM</td>
	<td align="left">string</td>
	<td align="left">身份证号(15位、18位数字)</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/StringOption.java">gu.dtalk.StringOption</a></td>
</tr>
<tr>
	<td align="left">BASE64</td>
	<td align="left">string</td>
	<td align="left">base64 格式二进制数据</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/Base64Option.java">gu.dtalk.Base64Option</a></td>
</tr>
<tr>
	<td align="left">MAC</td>
	<td align="left">string</td>
	<td align="left">6字节网卡MAC地址,保存为base64字符串即8 characters，如 'ODg4ODg4',不是'192.168.0.100'</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/MACOption.java">gu.dtalk.MACOption</a></td>
</tr>
<tr>
	<td align="left">IP</td>
	<td align="left">string</td>
	<td align="left">4字节IP地址,保存为base64字符串即8 characters，如 'ODg4OA==',不是'D0:17:C2:D2:3F:AE'</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/IPv4Option.java">gu.dtalk.IPv4Option</a></td>
</tr>
<tr>
	<td align="left">IMAGE</td>
	<td align="left">string</td>
	<td align="left">base64 格式JPEG/BMP/PNG格式图像</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/ImageOption.java">gu.dtalk.ImageOption</a></td>
</tr>
<tr>
	<td align="left">MULTICHECK</td>
	<td align="left">array</td>
	<td align="left">多选列表</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/CheckOption.java">gu.dtalk.CheckOption</a></td>
</tr>
<tr>
	<td align="left">SWITCH</td>
	<td align="left">number</td>
	<td align="left">单选列表</td>
	<td align="left"><a href="../dtalk-base/src/main/java/gu/dtalk/SwitchOption.java">gu.dtalk.SwitchOption</a></td>
</tr>
</tbody>
</table>
<h4>验证器(validator)</h4>
<p>选项(OPTION)允许应用层设置验证器对拟设置的值进行有效性验证，如果验证器返回false则会抛出异常。具体做法是通过<a href="../dtalk-base/src/main/java/gu/dtalk/BaseOption.java">gu.dtalk.BaseOption</a>的<code>setValidator</code>方法设置<code>Predicate</code>接口实例，示例如下：</p>
<pre><code>    OptionBuilder.builder(IntOption.class).name(&quot;status&quot;).readonly(true).value(0).instance().setValidator(new Predicate&lt;Integer&gt;() {

        @Override
        public boolean apply(Integer input) {
            return input != null &amp;&amp; input &gt; 100;
        }
    });
</code></pre>

<h3>(菜单)条目定义字段</h3>
<table>
<thead>
<tr>
	<th align="left">字段名</th>
	<th align="left">JSON type</th>
	<th align="left">说明</th>
	<th align="left">MENU</th>
	<th align="left">OPTION</th>
	<th align="left">CMD</th>
</tr>
</thead>
<tbody>
<tr>
	<td align="left">catalog</td>
	<td align="left">string</td>
	<td align="left">item分类类型，可选的值<code>MENU,OPTION,CMD</code>,参见《(菜单)条目类型说明》</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">name</td>
	<td align="left">string</td>
	<td align="left">条目名称([a-zA-Z0-9_],不允许有空格)</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">uiName</td>
	<td align="left">string</td>
	<td align="left">条目的用户界面显示名称,如果不指定则使用<code>name</code></td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">path</td>
	<td align="left">string</td>
	<td align="left">当前条目在整个菜单树形结构中以'/'分割子节点名字(name)的全路径,如'/device/mac',顶级根菜单(忽略<code>name</code>)的路径为'/',</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">container</td>
	<td align="left">bool</td>
	<td align="left">是否为容器(可包含item),当<code>catalog</code>为<code>MENU,CMD</code>时为true</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">description</td>
	<td align="left">string</td>
	<td align="left">对当前条目的说明文字，默认值：空</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">disable</td>
	<td align="left">bool</td>
	<td align="left">当前条目是否禁用,默认值:false</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">hide</td>
	<td align="left">bool</td>
	<td align="left">当前条目是否在用户界面中隐藏(不显示),默认值:false</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">childs</td>
	<td align="left">bool</td>
	<td align="left">所有子条目,当<code>catalog</code>为<code>OPTION</code>时，恒为空</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">empty</td>
	<td align="left">bool</td>
	<td align="left">是否有子条目,没有<code>childs</code>或<code>childs</code>中元素为0时为true,当<code>catalog</code>为<code>OPTION</code>时,恒为true</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">canceled</td>
	<td align="left">bool</td>
	<td align="left">取消正在执行的设备命令,为true时，指示取消正在执行的设备命令,仅对支持交互的设备命令有效</td>
	<td align="left"></td>
	<td align="left"></td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">needReset</td>
	<td align="left">bool</td>
	<td align="left">执行<code>CMD</code>/修改<code>OPTION</code>的值会不会导致设备重启</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left">Y</td>
</tr>
<tr>
	<td align="left">needRefresh</td>
	<td align="left">bool</td>
	<td align="left">修改<code>OPTION</code>值后前端要不要重新获取数据</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">type</td>
	<td align="left">string</td>
	<td align="left">选项的类型,可选的值参见《OPTION类型说明》</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">readOnly</td>
	<td align="left">bool</td>
	<td align="left">是否为只读的选项,当<code>catalog</code>为<code>CMD</code>时,恒为false</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">required</td>
	<td align="left">bool</td>
	<td align="left">是否为必须的选项，默认值:false</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">value</td>
	<td align="left">any</td>
	<td align="left">选项值,根据<code>OPTION</code>的类型不同可以有不同的类型</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">defaultValue</td>
	<td align="left">any</td>
	<td align="left">选项默认值,根据<code>OPTION</code>的类型不同可以有不同的类型</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">regex</td>
	<td align="left">string</td>
	<td align="left">当前选项的字符串合法性检查正则表达式</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">fieldRequire</td>
	<td align="left">number</td>
	<td align="left"><code>DATE Option</code>设备端要求的日期类型</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">precision</td>
	<td align="left">number</td>
	<td align="left"><code>FLOAT Option</code> 显示精度:小数点位数</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">options</td>
	<td align="left">object</td>
	<td align="left"><code>MULTICHECK</code>,<code>SWITCH</code> 可选项列表</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">available</td>
	<td align="left">array</td>
	<td align="left">已知可用的的值列表</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">width</td>
	<td align="left">number</td>
	<td align="left"><code>IMAGE Option</code> 图像宽度</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">height</td>
	<td align="left">number</td>
	<td align="left"><code>IMAGE Option</code> 图像高度</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
<tr>
	<td align="left">suffix</td>
	<td align="left">number</td>
	<td align="left"><code>IMAGE Option</code> 图像格式</td>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left"></td>
</tr>
</tbody>
</table>
<p><strong>NOTE</strong>:</p>
<ul>
<li>上表中后三列为Y，代表此字段适合该分类的菜单条目</li>
<li><code>options</code>目前使用允许的类型是<code>object</code>,未来可能会允许使用<code>array</code>,以保持列表元素顺序</li>
</ul>
<h3>创建菜单</h3>
<p>dtalk提供了<a href="../dtalk-base/src/main/java/gu/dtalk/ItemBuilder.java">gu.dtalk.ItemBuilder</a>用于创建menu和cmd,提供了<a href="..dtalk-base/src/main/java/gu/dtalk/OptionBuilder.java">gu.dtalk.OptionBuilder</a></p>
<p>如下是创建前面的示例的菜单的代码：</p>
<pre><code>public void test6Menu(){
    MenuItem menu1 = ItemBuilder.builder(MenuItem.class).name(&quot;menu1&quot;).uiName(&quot;菜单1&quot;).addChilds(
            ItemBuilder.builder(MenuItem.class).name(&quot;menu1_1&quot;).uiName(&quot;菜单1.1&quot;).addChilds(
                    OptionType.STRING.builder().name(&quot;option1&quot;).uiName(&quot;选项1&quot;).instance(),
                    OptionType.INTEGER.builder().name(&quot;option2&quot;).uiName(&quot;选项2&quot;).instance()
                    ).instance()
            ).instance();
    MenuItem menu2 = ItemBuilder.builder(MenuItem.class).name(&quot;menu2&quot;).uiName(&quot;菜单2&quot;).addChilds(
            ItemBuilder.builder(MenuItem.class).name(&quot;menu2_1&quot;).uiName(&quot;菜单2.1&quot;).addChilds(
                        ItemBuilder.builder(CmdItem.class).name(&quot;cmd1&quot;).uiName(&quot;命令1&quot;).instance().addParameters(
                                OptionType.STRING.builder().name(&quot;param1&quot;).uiName(&quot;命令参数1&quot;).instance()
                                )
                    ).instance()
            ).instance();
    RootMenu root = new RootMenu();
    root.addChilds(menu1,menu2);

    logger.info(BaseJsonEncoder.getEncoder().toJsonString(root));
}
</code></pre>

<p>完整代码参见 <a href="../dtalk-base/src/test/java/gu/dtalk/ItemTest.java">gu.dtalk.ItemTest</a></p>
<h3>设备命令实现</h3>
<p>根据设备命令执行方式的不同，分为立即(执行)设备命令和交互设备命令，立即设备命令执行后立即返回结果或不返回结果，立即命令执行的结果只有成功或异常两种状态。
交互命令适用于可能要长时间执行的命令，允许在设备命令执行教程中，管理端取消设备命令执行，也允许设备在设备命令执行过程，向管理端发送完成进度或人为取消。交互命令执行的结果状态更加复杂：成功，被拒绝，异常，超时。</p>
<h4>立即设备命令</h4>
<p>dtalk的立即设备命令由立即设备命令执行接口(<a href="../dtalk-base/src/main/java/gu/dtalk/ICmdImmediateAdapter.java">gu.dtalk.ICmdImmediateAdapter</a>)定义.</p>
<pre><code>/**
 * 设备命令执行接口
 * @author guyadong
 *
 */
public static interface ICmdImmediateAdapter {
    /**
     * 执行设备命令
     * @param input 以值对(key-value)形式提供的输入参数
     * @return 命令返回值，没有返回值则返回{@code null}
     * @throws CmdExecutionException 命令执行失败
     */
    Object apply(Map&lt;String, Object&gt; input) throws CmdExecutionException;
}
</code></pre>

<p>应用程序实现了设备命令执行接口后，通过<code>gu.dtalk.CmdItem.setCmdAdapter</code>方法绑定到指定的设备命令。当设备端收到这个设备命令时就会执行对应的<code>ICmdImmediateAdapter</code>实例.</p>
<p>该接口实例在<code>CmdItem</code>实例中被<code>gu.dtalk.CmdItem.runCmd</code>方法调用 </p>
<pre><code>/**
 * 执行立即命令
 * @return
 * @throws CmdExecutionException 设备命令执行异常
 */
public final Object runImmediateCmd() throws CmdExecutionException{
    checkState(cmdAdapter instanceof ICmdImmediateAdapter,&quot;type of cmdAdapter must be %s&quot;,ICmdImmediateAdapter.class.getSimpleName());
    synchronized (items) {
        if(cmdAdapter !=null){
            try {
                // 将 parameter 转为 Map&lt;String, Object&gt;
                Map&lt;String, Object&gt; objParams = Maps.transformValues(items, TO_VALUE);
                return ((ICmdImmediateAdapter)cmdAdapter).apply(checkRequired(objParams));                  
            } finally {
                reset();
            }
        }
        return null;
    }
}
</code></pre>

<h4>交互设备命令</h4>
<p>dtalk的交互设备命令由交互设备命令执行接口(<a href="../dtalk-base/src/main/java/gu/dtalk/ICmdInteractiveAdapter.java">gu.dtalk.ICmdInteractiveAdapter</a>)定义.</p>
<pre><code>/**
 * 交互设备命令接口
 * @author guyadong
 *
 */
public interface ICmdInteractiveAdapter extends ICmdUnionAdapter {
    /**
     * 执行设备命令
     * @param input 以值对(key-value)形式提供的输入参数
     * @param listener 状态侦听器，用于向管理端发送命令状态
     * @return 命令返回值，没有返回值则返回{@code null}
     * @throws InteractiveCmdStartException 当设备命令被拒绝或不支持或其他出错时抛出此异常,通过{@link InteractiveCmdStartException#getStatus() }获取状态类型
     */
    void apply(Map&lt;String, Object&gt; input,ICmdInteractiveStatusListener listener) throws InteractiveCmdStartException;
    /**
     * 取消当前执行的设备命令
     * @throws UnsupportedOperationException 设备命令不支持取消
     */
    void cancel() throws UnsupportedOperationException;
}
</code></pre>

<p>交互设备命令启动时，调用者会提供一个<code>ICmdInteractiveStatusListener</code>接口实例，用于设备命令执行时向调用层报告状态</p>
<pre><code>/**
 * 命令状态侦听器，用于交互命令向管理端发送命令执行状态
 * @author guyadong
 */
public interface ICmdInteractiveStatusListener{
    /**
     * 返回设备命令完成进度&lt;br&gt;
     * 设备命令在执行过程中应该定时调用此方法，以作为心跳发送给管理端，直到任务结束
     * @param progress 完成进度(0-100),可为{@code null}
     * @param statusMessage 附加状态消息,可为{@code null}
     */
    void onProgress(Integer progress,String statusMessage);
    /**
     * 任务结束,设备命令成功执行完成
     * @param value 命令执行返回值,没有返回值则为{@code null}
     */
    void onFinished(Object value);
    /**
     * 任务结束,执行中的设备命令被取消
     */
    void onCaneled();
    /**
     * 任务结束,调用抛出异常
     * @param errorMessage 错误信息，可为{@code null}
     * @param throwable 异常对象，可为{@code null}
     */
    void onError(String errorMessage, Throwable throwable);
    /**
     * 此方法用于设备命令发送方控制设备端定时报告进度的间隔(秒)，
     * 设备端调用此方法获取数值后，用于控制调用{@link #onProgress(Integer, String)}方法的调用间隔
     * @return 返回要求的{@link #onProgress(Integer, String)}方法调用间隔(秒)，&lt;=0时，使用设备自定义的默认值
     */
    int getProgressInternal();
}
</code></pre>

<h2>http连接</h2>
<p>为了增加dtalk的易用性，dtalk增加了http直接连接的功能。也就是设备端启动时启动一个基于nanohttpd的微型http服务。接收来自管理端的服务请求。</p>
<p>在此运行模式下，管理端与设备端的连接不再需要借助redis中转，而是直接送http请求到设备端。</p>
<p>dtalk http服务由<a href="../dtalk-engine/src/main/java/gu/dtalk/engine/DtalkHttpServer.java">gu.dtalk.engine.DtalkHttpServer</a>实现
调用示例参见 <a href="..//dtalk-demo/src/main/java/gu/dtalk/engine/demo/DemoHttpd.java">gu.dtalk.engine.demo.DemoHttpd</a></p>
<h2>http接口说明</h2>
<p>与Redis连接实现一样，http连接的菜单协议没有任何改变，不同的就是Redis实现时，菜单命令是从redis消息订阅频道接收,而http实现时，菜单命令直接来自http请求。</p>
<table>
<thead>
<tr>
	<th align="left">GET</th>
	<th align="left">POST</th>
	<th align="left">路径</th>
	<th align="left">参数</th>
	<th align="left">描述</th>
</tr>
</thead>
<tbody>
<tr>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">/<br>/index.html<br>/index.htm</td>
	<td align="left"></td>
	<td align="left">首页(静态页面)</td>
</tr>
<tr>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">/login</td>
	<td align="left">password:连接密码(默认为MAC地址后4位，比如3fbf)<br>isMd5(true/false):密码是否为MD5加密,默认为'true'</td>
	<td align="left">安全连接密码验证</td>
</tr>
<tr>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">/logout</td>
	<td align="left"></td>
	<td align="left">关闭连接</td>
</tr>
<tr>
	<td align="left"></td>
	<td align="left">Y</td>
	<td align="left">/dtalk</td>
	<td align="left">所有参数须为json格式,<br>指定菜单条目的'path'参数是必不可少的,比如:<br>{path:'/device'}</td>
	<td align="left">dtalk菜单请求</td>
</tr>
<tr>
	<td align="left">Y</td>
	<td align="left">Y</td>
	<td align="left">/dtalk${path}</td>
	<td align="left">POST请求时参数须为json格式,<br>指定菜单条目的'path'参数由${path}定义,比如 '/device/name'</td>
	<td align="left">dtalk菜单请求</td>
</tr>
</tbody>
</table>
<h2>任务队列</h2>
<p>(待续)</p>

</body>
</html>
<!-- This document was created with MarkdownPad, the Markdown editor for Windows (http://markdownpad.com) -->
